Temporal.PlainDateTime()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Der Temporal.PlainDateTime() Konstruktor erstellt Temporal.PlainDateTime Objekte.

Dieser Konstruktor ermöglicht es Ihnen, Instanzen direkt durch die Angabe der zugrunde liegenden Daten zu erstellen. Wie alle anderen Temporal Klassen sollten Temporal.PlainDateTime Objekte normalerweise mit der Temporal.PlainDateTime.from() statischen Methode konstruiert werden, die eine Vielzahl von Eingabetypen verarbeiten kann.

Syntax

new Temporal.PlainDateTime(year, month, day)
new Temporal.PlainDateTime(year, month, day, hour)
new Temporal.PlainDateTime(year, month, day, hour, minute)
new Temporal.PlainDateTime(year, month, day, hour, minute, second)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond, microsecond)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond, microsecond, nanosecond)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond, microsecond, nanosecond, calendar)

Note: Temporal.PlainDateTime() kann nur mit new konstruiert werden. Ein Versuch, es ohne new aufzurufen, wirft einen TypeError.

Parameter

year: Eine Zahl, die auf eine ganze Zahl gekürzt wird, repräsentiert das Jahr im ISO-Kalendersystem.
month: Eine Zahl, die auf eine ganze Zahl gekürzt wird, repräsentiert den Monat im ISO-Kalendersystem.
day: Eine Zahl, die auf eine ganze Zahl gekürzt wird, repräsentiert den Tag des Monats im ISO-Kalendersystem.
hour Optional: Eine Zahl, die auf eine ganze Zahl gekürzt wird, repräsentiert die Stundenkomponente.
minute Optional: Eine Zahl, die auf eine ganze Zahl gekürzt wird, repräsentiert die Minutenkomponente.
second Optional: Eine Zahl, die auf eine ganze Zahl gekürzt wird, repräsentiert die Sekundenkomponente.
millisecond Optional: Eine Zahl, die auf eine ganze Zahl gekürzt wird, repräsentiert die Millisekundenkomponente.
microsecond Optional: Eine Zahl, die auf eine ganze Zahl gekürzt wird, repräsentiert die Mikrosekundenkomponente.
nanosecond Optional: Eine Zahl, die auf eine ganze Zahl gekürzt wird, repräsentiert die Nanosekundenkomponente.
calendar Optional: Ein String, der den Kalender angibt, der verwendet werden soll. Sehen Sie sich Intl.supportedValuesOf() für eine Liste der häufig unterstützten Kalendertypen an. Standardmäßig wird "iso8601" verwendet. Beachten Sie, dass unabhängig vom calendar das year, month und day im ISO 8601 Kalendersystem sein müssen.

Rückgabewert

Ein neues Temporal.PlainDateTime Objekt, das das durch die Parameter spezifizierte Datum-Uhrzeit darstellt.

Ausnahmen

RangeError

Wird in einem der folgenden Fälle ausgelöst:

Eine Datum-Zeit-Komponente ist keine endliche Zahl.
Die Kombination aus Datum-Zeit-Komponente stellt kein gültiges Datum im ISO-Kalendersystem dar oder befindet sich nicht im darstellbaren Bereich, der ±(10⁸ + 1) Tage, oder etwa ±273.972,6 Jahre, seit dem Unix-Epoch umfasst.
calendar ist keine gültige Kalenderkennung.

Beispiele

Verwendung von Temporal.PlainDateTime()

const dt = new Temporal.PlainDateTime(2021, 7, 1);
console.log(dt.toString()); // 2021-07-01T00:00:00

const dt2 = new Temporal.PlainDateTime(2021, 7, 1, 0, 0, 0, 0, 0, 0, "hebrew");
console.log(dt2.toString()); // 2021-07-01T00:00:00[u-ca=hebrew]

Spezifikationen

Specification
Temporal # sec-temporal-plaindatetime-constructor